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2. . ABSTRACT 



The F. F. Loader will load a binary object tape produced by the PDP-7 Assembly 
System and will normally be punched by the assembly system at the beginning of such a tape. 

During read- in, a computed checksum will be compared against a checksum read 
from tape. The loader will halt if the checksums differ, displaying (in the AC) a word in which 
zeros indicate incorrect bits. When read-in is completed, the loader will execute the instruc- 
tions which were punched in the start block on the object tape. The address following the last 
constant stored by the loader (normally the first free location in memory) will be in the AC at 
this time. 

3. REQUIREMENTS 

3.1 Memory Locations 
17600-17755 (4k; 7600-7755) 

3.2 Subprograms 

Read-In Mode Loader (Digital-7-12-1) 

4. USAGE 

All library programs are written for an 8K machine. However, the program 
library is completely compatible with machines having larger and smaller memories. That is, 
any PDP-4 may be operated as an 8K machine (remembering only that programs stored in the 
upper half of an 8K memory will actually be stored in locations IOOOOq lower in a 4K machine). 
Consequently, switch settings and memory addresses are specified for an 8K machine. 

A binary tape of the F. F. Loader (supplied separately or preceding an object 
program) can be loaded by the Read-In Mode Loader (RIM) by placing the tape in the reader 
and depressing the START key with 17770 in the ADS (If RIM loader is not in memory, load 
RIM tape by depressing READ-IN switch on console). 

The F. F. Loader starting address is 17600. The loader assumes an RSB instruc- 
tion has been given to the tape reader before entry at 17600o To start the loader after position- 
ing the tape before the start block, an RSB must be placed in M^ll and the loader started there. 

When the loader is punched on an object tape by the Assembler, a jump to 17600 
is automatically executed after the loader Is placed in memory. The remainder of the object 
tape will be loaded automatically. If the loader is not punched on the object tape, a JMP 
17600 replaces it, causing the RIM loader to transfer control directly to the F. F. Loader (which 
must be in memory, see above). 
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If START followed by an address was used to terminate the source program, the 
F. F. Loader will transfer control to that address immediately after the tape is loaded. If 
PAUSE was used followed by an address, depressing CONTINUE will cause the control trans- 
fer. If either START or PAUSE are used with no ensuing address, the computer will halt after 
loading the program. To execute the program, the user will have to place the starting address 
in the address switches and depress START. In all cases, the AC will contain the location 
following the last constant stored. 

6. DESCRIPTION 

A tape in the format produced by the PDP-7 Assembler, Digital-7-3-S, (as 
described in the Assembler Output chapter) can be loaded by the F. F. Loader. The data 
block body contains the information to be loaded in F. F. binary. Interpretation of this in- 
formation is determined by the loader codes discussed below. Where to load the data generated, 
when to cease loading, and where to transfer machine control is determined by the data block 
heading, the termination block, and the start block, respectively (see Digltal-7-3-S). This 
information to the loader is punched in normal binary format. 

F. F. Binary 

F. F. Binary code is read in alphanumeric mode; that is, all eight bits on each 
line are taken as data. Each three lines of tape supply 24 bits of information to the loader. 
Of these, 18 form a data word and the remaining 6 instruct the loader how to handle the 
data word. 

To enable the loader to detect the end of a block of data, the number of words 
in each block is complemented and punched in the block heading. It is then indexed each 
time a word is read. Reading continues until this count is 0. Thus, if the block consists of 
n words, 3n lines of tape will be read, eight bits per line, to obtain the data. A word (three 
Tines) of F. F. Binary may be interpreted directly from the tape by the user if desired. Hold 
the tape with three holes to the right of the feed holes and five on the left. 

Reading as the loader does, from title to termination block, the first line is the 
eight least significant bits in the data word, the rightmost bit being bit 17. The second line 
is the next eight bits in the data word with bit 9 on the right. The third line from left to right 
contains two code bits not used by the F, F. Loader, followed by the four code bits which tell 
the F. F. Loader how to handle the data word. The rightmost two bits are bits and 1 of the 
data word. 

The data words in any block are loaded into memory from the highest location 
loaded by that block downward. The block heading contains the highest location loaded as 
the address of a DAC instruction. This address is decremented by one whenever a data word 
is loaded into memory. It will always indicate the next location to be loaded by the F. F. 
Loader. It is referred to as the current address indicator (CAI) in the code descriptions. 
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The F. F. Loader handling codes (four bits) and their meanings are: 
Code Meaning 

Storage word. Deposit the word in the address indicated by the CAi and decrement 
the CAI by one. 

1 Storage word with undefined symbol address. The address part of the word is the 
location of a register which now contains the value of the symbolic address which 
was undefined at assembly time (see code 3). Add the contents of the register 
address to the instruction part of the word to obtain the storage word. The storage 
word is then treated as in code 0. 

2 Reference to an undefined symbol. An undefined symbol occurred in an arithmetic 
operation. The word is the temporary location which contains the value of the 
undefined symbol (see code 3). The values of undefined symbols obtained from 
their temporary locations are combined until a word with code 0, 1, or 5 is en- 
countered. The symbol value is added if bit of the data word is 0, subtracted 

if bit is 1 . The accumulated undefined symbol values form the storage word 
processed when codes 0, 1, or 5 are encountered. 

3 Definition word. The data is a DAC instruction whose address is the temporary 
location assigned to store the definition of a previously undefined symbol which 
was defined at this point in the program. Deposit the contents of the CAI, plus 
one, into the addressed register. If the symbol was not defined equal to the 
value just deposited (e.g., a comma definition was not used), a word of type 4 
will follow to correct the definition. 

4 Undefined symbol's value. This word replaces the value defined in code 3 above. 
Deposit the value in the register indicated by the preceding code 3 word. 

5 Constant. Search the constants' table for the constant. Insert the word at the 
end of the table if it is not encountered. Then add the address of the register in 
which the constant is stored to the next storage word (the word which used the 
literal as an address). 

6 First three characters of a symbol . 

7 Second three characters of a symbol . 
10 Value of a symbol . 

11-17 Unused. 

Words with code 6, 7, and 10 are ignored during normal loading of a program. 
However, these words may be read by DDT-7 or the Assembler when punched in their respective 
formats (see PDP-7 Assembler, Digital-7-3-S). 
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As statements which have undefined symbol addresses are encountered by the 
Assembler, they generate code 1 words on the object tape. To avoid loading temporary symbol 
storage over another program or segment in memory, these registers are allocated sequentially 
beginning with the last address assignment (or 22 if no address assignment has occurred). The 
only difficulty which may be encountered occurs when the number of unique undefined symbols 
used since the last address assignment exceeds the number of locations since the last address 
assignment (or since location 22, if no assignment has been made), resulting in erroneous 
loading. In normal use, such an event will not occur, but the user should be aware of the 
possibility. 

Operating Characteristics 

When the Assembler punches a data block of an object tape, it calculates a check- 
sum (the sum of all words in the block excluding the checksum) and punches it in the heading. 
The F. F. Loader recalculates this sum on loading and compares it to the sum punched in the 
heading. If the two differ after loading a block of data, the computer will halt with a num- 
ber in the AC whose bits indicate where the computed checksum differs from the punched 
value. If repeated loadings will cause the same difference to appear in the AC lights, the 
object tape is probably faulty and should be reassembled. If the difference varies, the computer 
or reader may be causing the difficulty. Depressing CONTINUE will cause the loader to ignore 
the checksum; however, the recommended action is to reload the tape. 

During the loading process memory locations 7 and 10 are used for storage. Con- 
sequently these locations must not be used in the assembled program. When loading is completed, 
location 7 contains the first free address following the constants' storage area. 

8. TAPE FORMAT 

FIO DEC symbolic, ASCII symbolic 

9. EXECUTION TIME 
n.a. 
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10. 



PROGRAM 



10.4 



Program Listing 



ASCII 

P. P. LOADER 1-11-65 

TEMl^ 17777 RIB= 17762 TEM2=« RIB 

CONEND= 7 INDEX - 10 WORD* 10 

/READ START BLOCK 

17600/ 

FUNNY, JMS RIB 

DAC DONE 

JMS RIB 

DAC DONE 

JMS RIB 

DAC CONEND 

DAC CONBEG 

ISZ CONEND /READY FOR FIRST CONSTANT 
/READ DATA BLOCK HEADING 



/READ 2 WORDS 
/OR START 



CKSa 17775 



TO OBTAIN INSTR GEN BY PAUSE 



/READ ADDRESS WHEN START OR PAUSE ENCOUNTERED 

/CONSTANTS AREA SETUP 



BLOCK, 



CONT, 



JMS 


RIB 


DAC 


CAl 


SPA 




JMP 


DONE 


JMS 


RIB 


DAC 


TEMl 


ADD 


CAI 


DAC 


CKS 


JMS 


RIA 


DZM 


WORD 


ISZ 


TEMl 


JMP 


CC»^T1 



/READ STARTING ADDRESS 

/PLACE IN CURRENT ADDRESS INDICATOR 

/SKIP IP NEG, IE SKIP (TERMIN BLOCK) 

/END OF LOADING 
/READ WORD COUNT FOR THIS BLOCK 



/CHECKSUM 

/READ CHECKSUM 

/CLEAR ACCUMULATED WORD 
/FINISHED LOADING THIS BLOCK? 

Ao 



LAC CKS AES-CHECK CHECKSUM 

CMA 

SZA 

HLT /CHECK SUM ERROR 

RSB 

JMP BLOCK /CONTINUE 
/BREAK DOWN A P. P .BINARY WORD 
CONTl, JMS RIA /READ FIRST LINE OF A P. F .BINARY WORD 



DAC TByi2 

JMS RIA 

RTL 

RTL 

RTL 

RTL 

ADD TEM2 

DAC TEM2 



/READ SECOND LINE OF A P.P. BINARY WORD 



/DATA WORD, BITS 2-17 
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MS RIA /READ THIRD LINE OP A P. F .BINARY WORD 

RTR 

ADD CDSP 

DAC RIA /SET UP DISPATCH FOR WORD TYPE 

AND CCMA 

RAR 

ADD TEM2 /FORM WHOLE DATA WORD 

XCT I RIA /DISPATCH TO (DSP+LOADER CODE) WITH DATA WORD 

/IN AC 
JMP CONT /GET NEXT P,P .BINARY WORD 



/DISPATCH TABLE FOR MAGIC CODES 

DSPTCH, JMP CODEC /STORAGE WORD 

JMP CODEl /WORD WHOSE ADDRESS POINTS TO AN UNDEFINED 

JMP C0DE2 /ADDED OR SUBTRACTED VALUE 

JMP CODES /ADDRESS FOR AN UNDEFINED 

XCT C0DE4 /VALUE FOR AN UNDEFINED 

JMP CONST /CONSTANT, C0DE5 

NOP /FIRST SYM WORD, C0DE6 

NOP /SECOND SYM WORD, CODE? 

NOP /SYM CODEIO 
/START LOADED PROGRAM 
DONE, LAC CONEND /PLACE FIRST FREE ADDRESS IN AC 

XX /TRANSFER CONTROL OR HALT 

XX 
/STORAGE WORD, UNDEFINED ADDRESS 
CODEl, AND IMSK /MASK UNDEF. ADDRESS POINTER 

ADD I TEM2 /ADD VALUE OF UNDEF. ADDRESS AS A DAC 
/STORAGE WORD 

CODEC, ADD WORD /ACCUMULATED UNDEF. SYMB, VALUES 

CAI, XX /CURRENT ADDRESS INDICATOR 

CLC /-I, TWO'S COMP. 

TAD CAI /DECREMENT ADDRESS POINTER 

DAC CAI 

JWP CONT-1 /GET NEXT P. F .BINARY WORD 

/FOR-UNDEFINED SYMBOL 
C0DE2, CLAVSPA /ADD IP BITO=0 
CCMA, CMA /SUBTRACT IF BIT 0»1 

XOR I TEM2 /IF BIT WAS 0, SAME AS TEM2, IF BIT 

/WAS 1, CMA T1M2 

ADD WORD /ADD VALUE TO WORD 

C0DE2A, DAC WORD 

JMP CONT /GET NEXT P. P .BINARY WORD 

/POINTER TO WHERE AN UNDEFINED WILL BE STORED 
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C0DE3, DAC C0DE4 /SAVE DATA WORD, TEMP, LOCATION FOR UNDEFINED 

LAC CAI 

TAD CCMA /ADD 1 TO CURRENT ADDRESS INDICATOR 

C0DE4, XX /PUT CURRENT ADDRESS INDICATOR INTO TEMP. IX)CATIQN 

JMP CONT /GET NEXT F.F. BINARY WORD 



/READ 1 ALPHA WORD 
RIA, 

RSF 

JMP .-1 

RRB 

RSA 

DAC TEM 

ADD CKS 

DAC CKS /ACCUMULATE CHECK SUM 

LAC TEM 

CLL 

JMP I RIA 
/SOME CONSTANT STORAGE 
CDSP, DSPTCH 
IMSK, 760000 
TEM, 
CONBEG, 
/SEARCH AND STORE A CONSTANT, C0DE5 



CONST, ADD WORD 

DAC I CONEND 
LAC CONBEG 
DAC INDEX 
LAC I CONEND 

CONl, SAD I INDEX 
JMP FIND 
SAD I INDEX 
JMP FIND 
SAD I INDEX 
JMP FIND 
SAD I INDEX 
JMP FIND 
SAD I INDEX 
JMP FIND 
JMP CONl 

FIND, LAC INDEX 
SAD CONEND 
ISZ CONEND 



/ADD ANY UNDEP. SYMBOL VALUES TO CONSTANT AND 
/DEPOSIT IN MD OF CONSTANT TABLE 

/DEPOSIT BEGINNING ADDRESS OF TABLE IN INDEX 

/LOAD CURRENT CONSTANT VALUE 

/COMPARE TO CONSTANTS IN TABLE PREVIOUSLY 

/C (INDEX) IS AUTOMATICALLY INCREMENTED 
/BEFORE EACH TEST 



JMP C0DE2A 



PAUSE 



/IF NEW CONSTANT, INCREMENT POINTER TO END 

/OF CONSTANT TABLE 

/JUMP TO CODE 2A, PLACE VALUE OF CONSTANT IN WOR 
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